home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / f90 / verify.z / verify
Encoding:
Text File  |  1998-10-30  |  2.5 KB  |  59 lines
  1. VERIFY(3I)                                             Last changed: 1-6-98
  2.  
  3.  
  4. NNAAMMEE
  5.      VVEERRIIFFYY - Verifies that a set of characters contains all characters in
  6.      a string
  7.  
  8. SSYYNNOOPPSSIISS
  9.      VVEERRIIFFYY (([SSTTRRIINNGG==]_s_t_r_i_n_g,, [SSEETT==]_s_e_t [,,[BBAACCKK==]_b_a_c_k]))
  10.  
  11. IIMMPPLLEEMMEENNTTAATTIIOONN
  12.      UNICOS, UNICOS/mk, and IRIX systems
  13.  
  14. SSTTAANNDDAARRDDSS
  15.      Fortran 90
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      The VVEERRIIFFYY intrinsic function verifies that a set of characters
  19.      contains all characters in a string by identifying the first character
  20.      position in a string of characters that does not appear in a given set
  21.      of characters.  VVEERRIIFFYY accepts the following arguments:
  22.  
  23.      _s_t_r_i_n_g    Must be of type character variable.
  24.  
  25.      _s_e_t       Must be of type character variable, expression, or constant.
  26.  
  27.      _b_a_c_k      Must be of type logical.  If _b_a_c_k is omitted, a value of
  28.                false is assumed.
  29.  
  30.      VVEERRIIFFYY is an elemental function.  The name of this intrinsic cannot be
  31.      passed as an argument.
  32.  
  33. RREETTUURRNN VVAALLUUEESS
  34.      The result is an integer.
  35.  
  36.      If _b_a_c_k is absent or is present with a value FFAALLSSEE and _s_t_r_i_n_g contains
  37.      at least one character that is not in _s_e_t, the value of the result is
  38.      the position of the leftmost character of _s_t_r_i_n_g that is not in _s_e_t.
  39.  
  40.      If _b_a_c_k is present with a value TTRRUUEE and if _s_t_r_i_n_g contains at least
  41.      one character that is not in _s_e_t, the value of the result is the
  42.      position of the rightmost character of _s_t_r_i_n_g that is not in _s_e_t.
  43.  
  44.      VVEERRIIFFYY returns 0 if each character in _s_t_r_i_n_g is in _s_e_t, or if the
  45.      length of _s_t_r_i_n_g is 0.
  46.  
  47. EEXXAAMMPPLLEESS
  48.      Example 1:  The statement VVEERRIIFFYY((''AABBBBAA'',, ''AA'')) returns the value 2.
  49.  
  50.      Example 2:  The statement VVEERRIIFFYY((''AABBBBAA'',, ''AA'',, BBAACCKK==..TTRRUUEE..))  returns
  51.      the value 3.
  52.  
  53.      Example 3:  The statement VVEERRIIFFYY((''AABBBBAA'',, ''AABB'')) returns the value 0.
  54.  
  55. SSEEEE AALLSSOO
  56.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-2138, for the
  57.      printed version of this man page.
  58.  
  59.